MUL block

Short summary

Name	`MUL`
→POU type	→function
Category	Standard (safe), Numeric
Conform to →IEC-standard	currently restricted (IEC demands error handling, if the result of the block exceeds the range of values for the output data type. See "No check of invalid connections" for the behavior in Neuron Power Engineer.)
Graphical interface
Available since	version 1.0.0 (for Neuron Power Engineer) - initial variant version 3.8.0 (for library `Standard (safe)`): block provided in this library

Functionality

The mathematical function multiplication is called: The block returns the product of all values connected to the inputs.

No check of invalid connections

For some blocks, invalid connections are not checked by Neuron Power Engineer. Therefore, enter code in your application to detect invalid connections (e.g. IF-statements in the ST-code). See "Examples for invalid Connections".

See "Standard blocks for the application" for information what the consequences of an invalid connection might be.

Inputs, return value

	Identifier	→Data type	Description
Inputs:	`IN1`	`REAL`, `LREAL`, `USINT`, `UINT`, `UDINT`, `ULINT`, `SINT`, `INT`, `DINT` or `LINT` (corresponds to →generic data type `ANY_NUM`)	1st value
	`IN2`	`REAL`, `LREAL`, `USINT`, `UINT`, `UDINT`, `ULINT`, `SINT`, `INT`, `DINT` or `LINT` (corresponds to →generic data type `ANY_NUM`)	2nd value
	... (extensible until)
	`IN16`	`REAL`, `LREAL`, `USINT`, `UINT`, `UDINT`, `ULINT`, `SINT`, `INT`, `DINT` or `LINT` (corresponds to →generic data type `ANY_NUM`)	16th value
Return value:	–	`REAL`, `LREAL`, `USINT`, `UINT`, `UDINT`, `ULINT`, `SINT`, `INT`, `DINT` or `LINT` (corresponds to →generic data type `ANY_NUM`)

Input EN and output ENO are available when →calling the block. See "Execution control: EN, ENO" for information on input EN and output ENO.

See:

"Blocks for safe logic" whether this block is supported for developing safety-relevant applications.
"Highlighting safe logic in the FBD-editor" for the effects when using the block as a block for safe logic.

Example for usage within ST-editor

PROGRAM Test

VAR

      result : REAL;

   END_VAR

   result := MUL(IN1 := 10.0, IN2 := 2.0);    (* The variable 'result' evaluates to '20.0'. *)

END_PROGRAM

When creating your application within the ST-editor, enter a call of a block by typing the text as requested by the syntax or use Content Assist.

Examples for invalid connections

An invalid connection due to →overflows or →underflows might occur during a calculation using MUL.

Examples for invalid connections

Examples for invalid connections
`MUL(IN1 := SINT#100, IN2 := SINT#5);` `(* Overflow: '100 * 5' would evaluate to '500' but calculates '-12'. Upper limit for SINT is '127'. )` `MUL(IN1 := SINT#-100, IN2 := SINT#5);` `( Negative overflow: '-100 * 5' would evaluate to '-500' but calculates '12'. Lower limit for SINT is '-128'. *)` `MUL(IN1 := REAL#1.0e38, IN2 := REAL#3.0e38);`

MUL(IN1 := SINT#100, IN2 := SINT#5);

    (* Overflow: '100 * 5' would evaluate to '500' but calculates '-12'. Upper limit for SINT is '127'. *)

MUL(IN1 := SINT#-100, IN2 := SINT#5);

    (* Negative overflow: '-100 * 5' would evaluate to '-500' but calculates '12'. Lower limit for SINT is '-128'. *)

MUL(IN1 := REAL#1.0e38, IN2 := REAL#3.0e38);